home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 September / Macworld (1998-09).dmg / Updaters / Plot3D for pro Fit / Plot3D 2.1.0 - read me next >
Text File  |  1998-06-22  |  7KB  |  214 lines
  1. Plot3D, version 2.1.0
  2.  
  3.  
  4. Plot3D is a free plug-in that lets you use QuickDraw3D to produce 
  5. 3D models of data and functions. It takes the data from a spreadsheet 
  6. window or can generate a plot directly from a function definition.
  7.  
  8. It produces a 3D model of a surface plot or a scatter plot, 
  9. which can be interactively turned around and edited.
  10.  
  11. The 3D module can then be saved in the QuickDraw3D meta file 
  12. format (.3dmf), or can be exported as a high-resolution PICT.
  13.  
  14. The QuickDraw3D meta file format (.3dmf) is an excellent format 
  15. to let other people view your 3D plot because lots of applications 
  16. can view it (even SimpleText!).
  17. It can be used on Web pages and it can also be easily converted 
  18. into a QuickTime movie or other formats.
  19.  
  20.  
  21. For more information, see the QuickTime and QuickDraw3D web page:
  22.  
  23.                   <http://www.apple.com/quicktime/>
  24.  
  25.  
  26.  
  27. Plot3D is a plug-in module for the data analysis and scientific plotting 
  28. application pro Fit 5.1. Find more information about pro Fit 5.1 at
  29.  
  30.                   <http://www.quansoft.com/>
  31.  
  32. where you can also find the source-code of this plug-in.
  33.  
  34.  
  35. Plot3D uses QuickDraw3D.
  36.  
  37. Quickdraw 3D is a 3D-graphing package from apple which comes with 
  38. QuickTime. Find more information about it at
  39.  
  40.                   <http://www.apple.com/quicktime/>
  41.  
  42.  
  43.  
  44. Requirements
  45. To run Plot3D, you need a PowerPC Mac OS machine and  pro Fit 5.1 or later. 
  46. If you don't have pro Fit 5.1 yet,  download a FREE, fully functional version
  47. from
  48.                   <http://www.quansoft.com/trial.html>
  49.  
  50. or from any "info-mac" ftp server.  Since 3D graphing requires a large 
  51. amount of memory, we recommend that you assign at least 8 MB to pro Fit.
  52. Many more if you want to produce high-resolution pictures.
  53.  
  54. If Quickdraw 3D is not already installed on your system, you can
  55. download it from Apple's internet sites, such as 
  56.  
  57.                   <http://www.apple.com/quicktime/>
  58.  
  59. Be sure to check if you are using the latest version of QuickDraw3D.
  60.  
  61.  
  62.  
  63. Installation
  64. Once you have installed pro Fit 5.1, simply double-click the file Plot3D
  65. inside the "Plot3D module" folder.
  66.  
  67. Make sure that the following files are always kept together
  68. in the "Plot3D module" folder:
  69.  
  70.     Plot3D
  71.     Text3DLib
  72.     Triangulate.Lib
  73.  
  74. To add the module permanently to pro Fit, put the "Plot3D module"
  75. folder inside the "pro Fit modules" folder in pro Fit's folder.
  76.  
  77. See the pro Fit's help-system for further details about plug-ins.
  78.  
  79.  
  80.  
  81. Operating Instructions
  82. First prepare your data in a pro Fit data window, or prepare the function
  83. you want to plot (see the instructions which came with pro Fit to do this).
  84.  
  85. Then choose one of the Plot3D commands from the "Prog" menu.
  86.  
  87. Plot3D  installs the following commands in pro Fit's "Prog" menu:
  88.  
  89.  - Plot3D_Data_XY
  90.     Plots data. The data's x-, y- and z-coordinates must be arranged in
  91.     three rows in a data window.
  92.     Farther columns can be used to specify color and size of points 
  93.     when using the "scatter plot" option.
  94.  
  95.  - Plot3D_Data_RowCol
  96.     Plots a data matrix. The data's x- and y- coordinates are the column and row
  97.     numbers of the data window, the z-coordinates the values in the data
  98.     window.
  99.  
  100.  - Plot3D_Function
  101.     Plots a function. You can select 
  102.  
  103. Choose one of these commands to create a graph. The graph appears in a 
  104. graph editing window. You can then use the Save and Edit menus to edit 
  105. the graph. When you are through, click Done for placing a picture of the 
  106. graph in a drawing window, or select "Save As..." to save a 3DMF representation
  107. of the model.
  108.  
  109.  
  110. Getting the source code   
  111. The sources of the module and a project file for CodeWarrior Pro 2 are found at 
  112. QuantumSoft's download page: http://www.quansoft.com/down.html. 
  113. When compiling the project, you may have to add/correct Access Paths 
  114. depending on where you have the various header files.
  115.  
  116. The sources are available for free for your personal use, under the condition
  117. that any changes you make to them are also made available for free.
  118.  
  119. The easiest way to do this is to pass your changes to QuantumSoft, so that
  120. they can keep an up-to-date version for everybody to use.
  121.  
  122.  
  123. Customizing textures
  124. Plot3D allows you to apply a texture to the plotted surface instead of
  125. using a single color. There are various predefined textures that you can use. 
  126.  
  127. There isn't any nice interface to add textures yet, but i fyou are familiar 
  128. with ResEdit, you can use the following information to add your own textures: 
  129. The textures are stored in Plot3D as resources of type PICT with  IDs 
  130. starting from 31000. You can paste your own PICT resources as textures. 
  131. Note: the resource IDs of the texture PICTs must start from 31000 and 
  132. there must be no gaps in the numbers.  There can be up to 100 textures.
  133.  
  134.  
  135. Known problems
  136. The amount of memory required for plotting substantially depends on 
  137. the number of points in your plot. 
  138. When plotting around 10000 (e.g. 100 x 100) points, you should have at least 
  139. 16 MB of free memory, for plotting 65000 points (e.g. 256 x 256 points), 
  140. you need six times as much! When running out of memory, portions of memory 
  141. are swapped out to disk, which drastically affects speed and system stability. 
  142. Therefore, when working on large data sets, try to reduce the amount of data 
  143. (e.g. by using pro Fit's command "Data Reduction") before plotting.
  144.  
  145.  
  146.  
  147. Version history
  148.  
  149. Changes between 2.0.2 and 2.1.0
  150.  
  151. - improved compatibility with appearance and forthcoming themes
  152. - bug fixes
  153. - introduced the possibility of plotting data points as individual points
  154.   when using the "PlotDataXY" feature
  155.  
  156. Changes between 2.0.2 and 2.0.0
  157.  
  158. - bug fixes
  159.  
  160. Changes between 2.0.0 and 1.1.0
  161.  
  162. - 3D plots can now have ticks, labels and axis names. These items
  163.   can appear at each axis line and frame line.
  164.  
  165. - Surfaces can be textured.
  166.  
  167. - There's a new surface style: Basic. This style suppresses all shadowing
  168.    and ignores the position of the lights.
  169.  
  170. - You can now save and load the style of a graph - this provides a mechanism
  171.   for generating several graphs having the same settings for axes, labels,
  172.   camera, etc. The commands for loading, saving and deleting styles are
  173.   found in the File menu.
  174.  
  175. - All 3D plotting programs (for functions, xyz-data, Z(row,col)-data)
  176.   have been moved into a single module.
  177.  
  178. - Picture options are saved in automatically restored when you link the
  179.   module the next time.
  180.  
  181. - Bug fixes.
  182.  
  183. Changes between version 1.1.0 and version 1.0.0:
  184.  
  185. - Added the module "Plot3D Data Z(row,col)". This is a module
  186.   for 3D plotting of data. It takes a two-dimensional array
  187.   as input.
  188.  
  189. - Added a menu item "Camera & Illumination" for setting
  190.   the projection (parallel, point) and the location
  191.   of the illuminating lights.
  192.  
  193. - PICT Options now allows to set the depth of the PICTs
  194.  
  195. - PICT Options now allows to make a picture "transparent".
  196.   A transparent picture has the transfermode srcOr instead
  197.   of srcCopy
  198.  
  199. - The relative lengths of the axes can be set in the
  200.   Axes dialog.
  201.  
  202. - A frame (box) can be added by checking a checkbox in the axes
  203.   dialog.
  204.  
  205. - When creating a pict, the modules now first try to use temporary
  206.   memory before using the heap. This reduces the number of
  207.   messages "not enough memory"
  208.  
  209. - The main window shows the version number of the module at its
  210.   lower left corner.
  211.  
  212.  
  213. For more information see http://www.quansoft.com/
  214.